home *** CD-ROM | disk | FTP | other *** search
/ PD ROM 1 / PD ROM Volume I - Macintosh Software from BMUG (1988).iso / Programming / Programming Tools / XCMDs / SM.h < prev    next >
Encoding:
C/C++ Source or Header  |  1987-08-01  |  4.3 KB  |  223 lines  |  [TEXT/ttxt]
  1. /*    SM.h
  2.  *
  3.  *    This is an C include file that defines the public
  4.  *    interface of the Apple Sound Manager.
  5.  *
  6.  *    Copyright © Apple Computer, Inc. 1986, 1987
  7.  *    All Rights Reserved.
  8.  *
  9.  */
  10.  
  11. #ifndef __SoundManager__
  12. #define __SoundManager__
  13.  
  14. #include <types.h>
  15.  
  16.  
  17. /* Error codes */
  18. #define noErr                0
  19. #define noHardware            -200
  20. #define notEnoughHardware    -201
  21. #define queueFull            -203
  22. #define resProblem            -204
  23. #define badChannel            -205
  24. #define badFormat            -206
  25.  
  26. #define SynthCodeRsrc        'snth'
  27. #define SoundListRsrc        'snd '
  28.  
  29. #define NoteSynth            2
  30. #define WaveTableSynth        3
  31. #define MIDISynth            4
  32. #define SampledSynth        5
  33.  
  34.  
  35. #define TwelthRootTwo        1.05946309434
  36. typedef    long                Time;                /* in half milliseconds */
  37. #define InfiniteTime        0x7FFFFFFF
  38.  
  39.  
  40.  
  41. typedef struct SndCommand
  42. {
  43.     unsigned short            commandNum;
  44.     short                    wordArg;
  45.     long                    longArg;
  46. }
  47.     SndCommand;
  48.  
  49. #define NullCmd                0
  50. #define InitCmd                1
  51. #define FreeCmd                2
  52. #define QuietCmd            3
  53. #define FlushCmd            4
  54.  
  55. #define WaitCmd                10
  56. #define PauseCmd            11
  57. #define ResumeCmd            12
  58. #define CallBackCmd            13
  59. #define SyncCmd                14
  60. #define EmptyCmd            15
  61.  
  62. #define TickleCmd            20
  63. #define RequestNextCmd        21
  64. #define HowOftenCmd            22
  65. #define WakeUpCmd            23
  66. #define AvailableCmd        24
  67.  
  68. #define ScaleCmd            30
  69. #define TempoCmd            31
  70.  
  71. #define NoteCmd                40
  72. #define RestCmd                41
  73. #define FreqCmd                42
  74. #define AmpCmd                43
  75. #define TimbreCmd            44
  76.  
  77. #define WaveTableCmd        60
  78. #define PhaseCmd            61
  79.  
  80. #define SoundCmd            80
  81. #define BufferCmd            81
  82. #define RateCmd                82
  83.  
  84. #define DataPointerFlag        0x8000
  85.  
  86. typedef struct ModifierStub
  87. {
  88.     struct ModifierStub        *next;
  89.     ProcPtr                    modifierCode;
  90.     long                    userInfo;
  91.     Time                    count,
  92.                             every;
  93.     char                    flags;
  94.     char                    hState;
  95. }
  96.     ModifierStub, *ModifierStubPtr;
  97.  
  98.  
  99.  
  100. #define StdQLength            128
  101.  
  102. typedef struct SndChannel
  103. {
  104.     struct SndChannel        *next;
  105.     ModifierStubPtr            modifierChain;
  106.     ProcPtr                    callBack;
  107.     long                    userInfo;
  108.     
  109.     /* The following is for internal Sound Manager use only. */
  110.     Time                    wait;
  111.     SndCommand                cmdInProgress;
  112.     short                    flags;
  113.     short                    qLength,
  114.                             qHead,        /* next spot to read or -1 if empty */
  115.                             qTail;        /* next spot to write, = qHead if full */
  116.     SndCommand                queue[StdQLength];
  117. }
  118.     SndChannel, *SndChannelPtr;
  119.  
  120.  
  121.  
  122. /* Standard Synthesizer Structures */
  123.  
  124. /* Sampled Sound Synthesizer */
  125.  
  126. typedef struct SoundHeader
  127. {
  128.     char                * samplePtr;    /* if NIL then samples are in sampleArea */
  129.     unsigned long        length;
  130.     Fixed                sampleRate;
  131.     unsigned long        loopStart,
  132.                         loopEnd;
  133.     short                baseNote;
  134.     char                sampleArea[0];
  135. } SoundHeader, *SoundHeaderPtr;
  136.  
  137.  
  138. /* Wave Table Synthesizer <C??? 13jan87 mgl>*/
  139.  
  140. #define WaveInitChannelMask        0x07
  141. #define WaveInitChannelLeft        0x02
  142. #define WaveInitChannelRight    0x03
  143. #define WaveInitChannel0        0x04
  144. #define WaveInitChannel1        0x05
  145. #define WaveInitChannel2        0x06
  146. #define WaveInitChannel3        0x07
  147. #define WaveInitSRateMask        0x30
  148. #define WaveInitSRate22k        0x20
  149. #define WaveInitSRate44k        0x30
  150. #define WaveInitStereoMask        0xC0
  151. #define WaveInitStereoMono        0x80
  152. #define WaveInitStereoStereo    0xC0
  153.  
  154.  
  155.  
  156. /* Sound List Resource Format */
  157.  
  158. /* the zero array sizes are here mearly to get this through the compilier */
  159.  
  160. typedef struct SndListResource
  161. {
  162.     short                format;
  163.     short                numModifiers;
  164.     struct modRef {
  165.         unsigned short    modNumber;
  166.         long            modInit;
  167.     }                    modifierPart[0];
  168.     short                numCommands;
  169.     SndCommand            commandPart[0];
  170.     char                dataPart[0];
  171. } SndListResource, *SndListPtr;
  172.  
  173. #define FirstSoundFormat    0x0001        /* first and only version we can deal with */
  174.  
  175.  
  176. #ifndef __SoundManagerTraps__
  177. #define __SoundManagerTraps__
  178.  
  179. /* User callable routines */
  180. pascal OSErr SndDoCommand(chan, cmd, noWait)
  181.     SndChannelPtr        chan;
  182.     SndCommand            * cmd;
  183.     Boolean                noWait;
  184. extern 0xA803;
  185.  
  186. pascal OSErr SndDoImmediate(chan, cmd)
  187.     SndChannelPtr        chan;
  188.     SndCommand            * cmd;
  189. extern 0xA804;
  190.  
  191. pascal OSErr SndAddModifier(chan, modifierCode, id, init)
  192.     SndChannelPtr        chan;
  193.     ProcPtr                modifierCode;
  194.     short                id;
  195.     long                init;
  196. extern 0xA802;
  197.  
  198. pascal OSErr SndNewChannel(chanVar, synth, init, userRoutine)
  199.     SndChannelPtr        * chanVar;
  200.     short                synth;
  201.     long                init;
  202.     ProcPtr                userRoutine;
  203. extern 0xA807;
  204.  
  205. pascal OSErr SndDisposeChannel(chan, quietNow)
  206.     SndChannelPtr        chan;
  207.     Boolean                quietNow;
  208. extern 0xA801;
  209.  
  210. pascal OSErr SndPlay(chan, sList, async)
  211.     SndChannelPtr        chan;
  212.     Handle                sList;
  213.     Boolean                async;
  214. extern 0xA805;
  215.  
  216. pascal OSErr SndControl(id, cmdVar)
  217.     short                id;
  218.     SndCommand            * cmdVar;
  219. extern 0xA806;
  220.  
  221. #endif
  222.  
  223. #endif